home *** CD-ROM | disk | FTP | other *** search
/ Enigma Amiga Life 112 / EnigmaAmiga112CD.iso / dalla rivista / awnpipe / awnp / awnp-docs / aexample.doc < prev    next >
Text File  |  2000-05-18  |  3KB  |  79 lines
  1. You should read the simple examples before trying these more advanced ones.
  2.  
  3. HINT: use right Amiga C the drag then clip the examples out of these docs to avoid typos.
  4.  
  5.  
  6. ---
  7.  
  8. It is possible to tap into or duplicate the data passed in a pipe. '/t' will add a readonly third end to a pipe.
  9.  
  10. Make sure you have two different shells available.
  11.  
  12. In the first shell type 'type awnpipe:mypipe/t'
  13.  
  14. In the second shell type 'echo >awnpipe:mypipe hello'
  15. In the second shell type 'type awnpipe:mypipe '
  16.  
  17.  The word hello came back from both the second end of the pipe and the 'Tap' third end.
  18.  
  19. ---
  20.  
  21. In the first shell type 'copy con:////pipe-test/close awnpipe:mypipe'
  22. In the second shell type 'type awnpipe:mypipe '
  23.  
  24. Type a few lines of text into the test con:, nothing comes out in the second shell. Close the test con:, now the data comes out. This is because the type command wants to read large blocks of data.
  25.  
  26. '/i' will cause data to pass out of the pipe immediately (as soon as its available).
  27.  
  28. In the first shell type 'copy con:////pipe-test/close awnpipe:mypipe'
  29. In the second shell type 'type awnpipe:mypipe/i '
  30.  
  31. Now the text comes out of the pipe each time you hit return in the test con:.
  32. Close the test con: to end the example.
  33.  
  34. ---
  35.  
  36. You can use AWNPipe to read the tooltypes of an icon. The second end of the pipe automatically reads the tooltypes of FILENAME when '/xiFILENAME' is used. NOTE that parameters that start with '/x' can not be mixed with other parameters!
  37.  
  38. In a shell type 'type awnpipe:mypipe/xiDevs:dosdrivers/awnpipe'
  39.  
  40. YES the pipe name contains two colons ':', don't let it bug you.
  41.  
  42. The tooltype information from Devs:dosdrivers/awnpipe prints out. Note you do not include '.info' in the file name.
  43.  
  44. The data is typed out in the following format..
  45.  
  46. icon_type x y stack
  47. default tool
  48. tool window
  49. first tooltype
  50. second tooltype
  51. ...
  52.  
  53. If you get some weird number (-2147483648) for the X and Y values it means you did not snapshot the icon yet.
  54.  
  55. ---
  56.  
  57. You can also use AWNPipe to write the tooltypes of an icon.
  58.  
  59. Copy a file with its icon into ram:., preferably an icon that has some tooltypes set in it.
  60.  
  61. In a shell 'copy awnpipe:/xiRam:filename ram:icondump' , do not include '.info' in the filename.
  62.  
  63. Now examine and edit the file ram:icondump change the default tool and tooltypes.
  64.  
  65. In a shell 'copy ram:icondump awnpipe:/xsRam:filename '.
  66.  
  67. Use the WB menu info function to verify the new setting in the icon.
  68.  
  69. ---
  70.  
  71.  AWNPipe can be used to pattern match. '/xm' is used for pattern matching. Data is usually written into the pipe, and the results of the pattern matching read back from THE SAME END OF THE PIPE. The second end of the pipe is automatically connected to a task that is doing the pattern matching. '/xmrFILENAME' causes the data to be read from a file rather than the pipe, the match results are read from the pipe.
  72.  
  73. In a shell type 'type awnpipe:mypipe/xmrcon:////pipetest/close'
  74.  
  75. In the pipetest con: type '#?a' . This sets a pattern to match any text ending in 'a'. 'ok 1' should come back from the pipe. ('ok 0' would means you did not enter a pattern so an exact match will be tested for.)
  76.  
  77. In the pipetest con: enter some text. If the text ends with 'a' then the pipe responds with '1' meaning a match. If not the pipe responds with '0' meaning no match. Close the pipe test con: to end the example.
  78.  
  79.